platforms/MacOSX/aMule-Xcode/README BEFORE BUILDING.rtf

   1 {\rtf1\ansi\ansicpg1252\cocoartf1038\cocoasubrtf290
   2 {\fonttbl\f0\fnil\fcharset0 Monaco;\f1\fmodern\fcharset0 Courier;}
   3 {\colortbl;\red255\green255\blue255;}
   4 \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural
   5
   6 \f0\fs20 \cf0 This project allows for compilation of aMule in Xcode \ul without\ulnone  macports / fink. THIS IS NOT AN EASY PROCESS, so only attempt it if you're familiar with the terminal, and compiling programs there, as wxWidgets and cryptopp are still compiled via the terminal. I hope to automate this process in the future to eliminate that requirement.\
   7 \
   8 Compiling aMule on Xcode is important to automate the build of different configurations, ensure proper compatibility, and allow developers to use the Xcode interface to gdb which is tremendously useful to track and solve bugs. \
   9 \
  10 Current configuration supports i386/ppc build on SDK 10.4 (for Tiger), without country flags or UPnP, using wxWidgets 2.8.x. Other configurations will be added later.\
  11 \
  12 It's important for building that the following steps/requirements are met:\
  13 \
  14 1) This folder structure is needed for compilation:\
  15   \
  16   <some folder in your computer>\
  17         |\
  18         |-> aMule sources\
  19         |\
  20         |-> wxWidgets-2.8\
  21         |\
  22         |-> cryptopp\
  23         \
  24 It's essential that the folders are named exactly like shown. If you want to change this, take a look at CFLAGS and link flags in the "aMule" target's properties.\
  25 \
  26 2) wxWidgets has to be compiled with universal binary support and static library. It's important that gcc-4.0 is used when compiling on Snow Leopard because gcc-4.2 defaults to 64bits builds, which wxWidgets 2.8.x doesn't support (see {\field{\*\fldinst{HYPERLINK "http://wiki.wxwidgets.org/Development:_wxMac#Building_on_Snow_Leopard_for_Snow_Leopard"}}{\fldrslt http://wiki.wxwidgets.org/Development:_wxMac#Building_on_Snow_Leopard_for_Snow_Leopard}} for more info).\
  27 \
  28 Personally I use the following:\
  29 \
  30 \pard\pardeftab720\ql\qnatural
  31
  32 \f1\fs24 \cf0 svn checkout http://svn.wxwidgets.org/svn/wx/wxWidgets/branches/WX_2_8_BRANCH wxWidgets-2.8\
  33 \
  34 \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural
  35
  36 \f0\fs20 \cf0 to check out the sources, and configure with\
  37 \
  38 \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural
  39
  40 \f1\fs24 \cf0 ./configure  CC=gcc-4.0 CXX=g++-4.0 LD=g++-4.0 --enable-debug --with-macosx-sdk=/Developer/SDKs/MacOSX10.4u.sdk --with-macosx-version-min=10.4 --enable-universal_binary --disable-universal --disable-shared \
  41 \
  42 \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural
  43
  44 \f0\fs20 \cf0 After that, just type "make" as usual. Do not "make install".\
  45 \
  46 3) Compiling cryptopp is complicated due to lack of proper support for building on MacOSX, especially for universal binaries. First download a cryptopp release from {\field{\*\fldinst{HYPERLINK "http://www.cryptopp.com/#download"}}{\fldrslt http://www.cryptopp.com/#download}} (latest are at the bottom) and uncompress it to the folder named "cryptopp" as shown in the folder structure above. Then, edit the file named GNUmake and add the following lines at the beginning:\
  47 \
  48 \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural
  49
  50 \f1\fs24 \cf0 CXXFLAGS = -arch i386 -arch ppc -isysroot /Developer/SDKs/MacOSX10.4u.sdk -mmacosx-version-min=10.4 -DNDEBUG -g -O2\
  51 LDFLAGS = -arch i386 -arch ppc -isysroot /Developer/SDKs/MacOSX10.4u.sdk -mmacosx-version-min=10.4\
  52 CXX=c++-4.0\
  53 CC=gcc-4.0\
  54 \
  55 \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural
  56
  57 \f0\fs20 \cf0 Save the file, then type "make" as usual. Do not "make install".\
  58 \
  59 Once you have finished compiling cryptopp and wxWidgets-2.8, and they are in the right folders, this project should compile correctly. If you get errors, please review all the steps before posting in the forum.\
  60 \
  61 Good luck!
  62 \f1\fs24 \
  63 \pard\pardeftab720\ql\qnatural
  64 \cf0 \
  65 - Kry\
  66 }